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This publication describes the internal logic of the 
On Line Test Control Program for IBM System/36 Time 
Sharing System (TSS/360) . It is intendec. for use with 
the appropriate program listings. Its primary purpose 
is to serve as a guide to those listings. 

This program logic manual is directed to the IBM 
customer engineer wno is responsible for program 
maintenance. It can be used to locate specific areas 
of the program, and it enables the reader to relate 
these areas to the corresponding program listings. 
Program logic information is not necessary for program 
operation and use. 



PREFACE 



This program logic manual is a detailed 
guide to the On Line Test Control program 
for TSS/360. It supplements the program 
listing by providing descriptive text and 
flowcharts. 

Effective use of this manual requires an 
understanding of IBM System/360 operation 
and of Time Sharing System/360. Reference 
publications for this information are: 

IBM System/360 Principles of Operation , 
Form A22-6821 

IBM System/360 Time Sharing System: 

Concepts and Facilities , Form 

C28-2003 

IBM System/360 Time Sharing System; Sys- 
tem Programmer's Guide , Form C28-2008 

IBM System/360 Time Sharing System: 
Command System User's Guide , Form 
C28-2001 

IBM System/360 Time Sharing System: 
Manager's and Administrator's Guide , 
Form C28-2024 

Second Edition (January 1970) 

This is a major revision of, and makes obsolete, Y28-2042- 
1 and Technical Newsletter Y28-3069. 

This revision incorporates the changes resulting from the 
addition of the Remote Terminal Access Method (RrAM) to the 
system, and the removal of the Basic Sequential Access Method 
Print Option. 

Changes to pages are indicated as follows: 

Symbol Meaning 

• (next to a page number The page (or illustration) 
or caption of an has been revised and should 

illustration) be reviewed in its entirety. 

[ (in the margin Adjacent text contains a 

left of the text) change. CThis symbol is not 

used if a bullet appears 
next to the page number.) 

This edition applies to Version 6 r Modification r of IBM 
System/36 Time Sharing System, and to all subsequent 
releases until otherwise indicated in new editions or Techn- 
ical Newsletters. Changes are periodically made to the 
(specifications) herein; before using this publication in 
connection with the operation of IBM systems, refer to the 
latest edition of IBM System/3 6 Time Sharing System: Adden- 
dum , Form C28-2043, for the editions of publications that are 
applicable and current. 

The contents of this publication are subject to change 
from time to time. Any such changes will be reported in 
subsequent revisions or Technical Newsletters. 

This publication was prepared for production using an IBM 
computer to update the text and to control the page and line 
format. Page impressions for photo-offset printing were 
obtained from an IBM 1403 Printer using a special print 
chain. 

Requests for copies of IBtyi publications should be made to 
your IBM representative or to the IBM branch office serving 
your locality. 

A form is provided at the back of this publication for 
reader's comments. If the form has been removed, comments 
may be addressed to IBM Corporation, Time Sharing System/360 
Programming Publications, Department 643, Neighborhood Road, 
Kingston, N.Y. 12401 

& Copyright International Business Machines Corporation 1967, 
1968, 1970 
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INTRODUCTION 



O N LINE TEST SYSTEM (OLTS) 

The On Line Test System (OLTS) is a collection of programs designed 
to assist the IBM customer engineer (CE) in testing and maintaining the 
hardware of the System/ 360 Model 67. A control program and a group of 
device-oriented test programs make up the system. All OLTS programs run 
in virtual storage in conversational mode. The test programs are non- 
privileged; the control program is made up of several routines, three of 
1 which are privileged. OLTS shares most system resources except the ele- 
I ment under test. OLTS needs only minimum hardware requirements. 

OLTS has the following purposes and uses: 

1. On known error - to exercise the failing equipment, in order to 
further locate the malfunction. 

2. After repair - to verify the repair prior to making the item avail- 
able to customers again. 

3. In adjustment - to provide a tool to assist in making adjustments 
to the equipment . 

4. For periodic check - to ascertain condition of element. 
Overall operation of the On Line Test System is shown in Figure 1. 

ON LINE TEST CONTROL PROGRAM (OLTCP) 



The On Line Test Control Program is the major interface between OLTS, 
the CE, and the I/O supervisor,- it is also a source of utility routines 
for the test programs. See Figure 2. 

FUNCTIONS 

The functions of OLTCP are: 

• Job Setup 

• Device Allocation 

• Test Sequencing 

• I/O Control 

• Utilities 

Initiation and Job Setup 

The setup modules CMATF and CZATG (Figure 1) gain control as a result 
of the RUN command and enter direct communication with the CE at the 
SYSIN-SYSOUT device. 
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Figure 1. Overall Operation of On Line Test System 
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Control Attention Interrjpts 
CE Communication 
Load Test Sections 
Timer Services 
Attention interrupts 
Release Printer 



System Operator Communication 

Allocate Devices for Test 

Locate SDA for SYSIN/SYSOUT Terminals 

Locate JFCEs 

Retrieve Records from Terminal and Subsystem Table 

Update TSDL 

Timer Services 

Release Devices 

CE Communication 

Obtain Storage 



Write to Output Device 
Hexadecimal - EBCDIC Conversions 

I/O to Device Under Test 
Abnormal Termination 
Posting for I/O 
Abnormal Termination 



• Figure 2. OLTCP Interfaces to Other Parts of TSS/36 
The CE enters: 

1. The unique symbolic name assigned to the units or subsystems to be 
tested 

2. The names of the test sections to be run 

3. The routines of a selected test section 

4. Run options 

This information is used to get the devices allocated, call the test 
sections and build tables defining the job request. 

The tables constructed are: the section control table (Appendix A) f 
which describes the job to the test programs, and the section list, 
which lists the sections selected for sequencing. In addition, a table 
describing terminal attributes is constructed if terminal tests are 
selected. 
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Test Sequencing 

When the job request has been defined, the sequencer subroutine is 
entered. This subroutine operates on the section list constructed by 
the setup routines. It gives control, in turn, to each section in the 
list, passing to each a pointer to the section control table, which 
describes the job to be performed. The section tests the devices 
described in the section control table, using the routines and options 
chosen by the CE. 

On Line Test Access Method (OUAM) Interface to Hardware 

Test sections may access I/O hardware via the on line test access 
method (OLTAM) , standard access methods, or a combination of these. 
OLTAM consists of two routines that interface test program I/O opera- 
tions to the supervisor. It exists because system access methods do 
not, in general, provide the flexibility required by test programs. 

OLTAM allows test programs to specify their own CCW lists. OLTAM 
permits a test program to specify an I/O path of its own choosing, rath- 
er than accepting an arbitrary path provided by other access methods. 
If the specified path is busy, the request will be queued in the super- 
visor until the path becomes free. OLTAM returns condition codes to the 
test program, along with CSW and sense data if applicable. It returns 
the final CSW and sense data on completion of the operation. This 
information is placed in an OLTAM-def ined test event control block 
(TECB) for use by the test program. Test event control blocks are sum- 
marized in Appendix D. OLTAM interfaces to the supervisor via the IORCB 
and the IOCAL SVC. 

OLTAM provides a posting routine which provides the essential ser- 
vices involved in marking an I/O event complete and passing status 
information to the test program. 



Output 

Test results, usually in standard formats, are displayed on a device 
designated by the CE. The OLTCP print routine CCMATC) provides uniform 
message formatting and directs results to the SYSIN-SYSOUT terminal (via 
the GATE routine) . 

Utilities 

Two utility routines are provided. The Convert routine converts 
EBCDIC and HEX; the Compare routine compares expected and received 
results of I/O operation for test programs. 

Dynamic Control 

OLTS may be interrupted dynamically to change options, end a test 
section, redefine a job, or end a session. The CE presses ATTENTION at 
SYSIN, and a routine prompts for and processes changes. 



ORGANIZATION 

The following modules, all of which are parallel, reenterable, and 
run in virtual storage, make up the OLTCP. 



Module Title Privileged 

Setup CMATF No 

Device Allocation CZATG Yes 

OLTAM Execute I/O CZATA Yes 

OLTAM Posting CZATB Yes 

Print CMATC No 

Convert CMATE No 

Compare CMATD No 

Setup Control Routine (CMATF) 

This routine: 

1. Communicates with the CE at the SYSIN device to obtain test 
parameters. 

The format of a non-prompt-mode entry is 
DEVICES/TESTS, ROUTINES/OPTIONS 

For example, 

10 , 11/2311A, 5/NEP, EL 

which says: test symbolic devices 10 and 11, using test section 

2311A, Routine 5; loop on errors, and do no error printing. 

2. Calls the device allocation routine (CZATG) to get devices allo- 
cated, and complete the device fields of the section control table. 
(CZATG interfaces to system device management routines.) 

3. Constructs the test option and routine selection fields of the SKT . 
<*. Loads and sequences test programs. 

Entry Point : SYSTEST, via RUN command; Type-Ill linkage. 

Inpu t : None . 

Operation : SETUP is entered from the command system by the sequence of 
a LOGON and RUN command. As soon as the routine is entered, a request 
for input parameters is sent to SYSIN, via the GATE subroutine. At this 
point, if the CE desires to enter the prompting mode, the PROMPT MODE 
flag is set so that the routines that analyze the parameters will prompt 
for them. 

The device allocation routine (CZATG) , the section selection subrou- 
tine, the routine selection subroutine (if applicable) f the test option 
subroutines and sequencer subroutine are run (the subroutines are within 
CMATF). After sequencing all selected tests, the loop-test option is 
tested; if set, the entire job is rerun; if off, return is made to the 
beginning of setup, from which the request for input parameters is 
repeated. 

The job may be ended at any time via LOGOFF. 

The major subroutines of CMATF are: 

S ECTION SELECTION SUBROUTINE : This subroutine analyzes the input stream 
to pick up test selections, determines whether the requested sections 
are available, and constructs a list of the available requested sections 
for subsequent sequencing. 

The section selection subroutine is entered from the setup control 
routine. Upon entry, the OLTS prompt mode flag is checked. If it is 
on, a prompting message is sent to SYSIN. When the response arrives, or 
if no prompt was made, the input stream is checked for a 4-digit number. 
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If this number is not present. , an error message is sent to SYSIN, and 
prompting is initiated. A series of letters f commas, and dashes will 
follow the 4-digit numeral* These characters are expanded into full 
test section names, and the modules are loaded, via the dynamic loader, 

to verify their availability* As each section is loaded r its name and 
address constants are entered into the section list, and the section 
counter is incremented. A slash or a decimal digit signals the end of 

the section field* 

E rror Checks ; A check is made to determine that the first four charac- 
ters of the section selection field are decimal digits. 

The input stream is monitored for illegal or illogical character 
appearance. 

The availability of each requested section is checked by an attempt 
to load it into virtual storage. 

Checks are made that at least one section has been successfully 
loaded, and that no more than 2 6 sections have been selected. 

If any error is detected, the CE is given the option to erase current 
selections and make new selections. 

ROUTINE SELECTION SUBROUTINE : This subroutine sets up the routine 
selection half word in the section control table . It is entered only 
when a single test section has been requested, and the CE desires to run 
specific routines within this test section- 

On entry, if the prompt flag is set, a request for routines is sent 
to the CE at SYSIN. If the prompt flag is not on, the routine selection 
data will be taken from the main input stream. The input is checked for 
routine numbers 1 to 16, and the respective bits are set in the routine 
selection ha If word of the section control table. 

Error Checks : Permissible characters are decimal digits, commas, blanks 
and dashes. If an illegal character or a legal character in an illogi- 
cal context is encountered, the CE is informed of the error and is given 
the option to retain current routine selections or to erase them and 
make new selections. 

Routine numbers are from 1 to 16, inclusive. 

OPTION SELECTION SUBROUTINE ; This routine sets bits in the job option 
halfword of the section control table. The available options are: 

• No control printouts 

• No error printouts 

• Loop if error detected 

• Loop the test 

• Scope Loop 

This routine first checks to see if the prompt mode flag is set. If 
so, a request for options is sent to the CE. The response contains 
either the options desired or the character D for DEFINITION. If D, 
another message defining the option codes is sent to the CE. The CE 
enters the desired options which are checked against permitted options, 
and when a match is found, the respective bit in the job option halfword 
is set. 



Error Checks ; An illegal entry causes a message to the CE that defines 
current options and allows new selections. 

S EQUENCE SUBROUTINE : This subroutine runs the test sections in the or- 
der specified by the CE. 

The sequence subroutine, encered from the setup control routine, 
calls test sections, based on entries in the section list. Normally, a 
message is printed prior to entering a test section (e.g., * , S2250A W ) and 
on return from a test section ( W T W ), 

On entry to the test section, register 1 points to a. 4-word parameter 
list; 

Word 1 - Pointer to the Section Control Table 

Word 2 - Pointer to the Internal Terminal Table 

Word 3 - Pointer to the Relocated SDAT* 

Word 4 - Pointer to the nonrelocated SDAT 

On return from a test section, general register 15 contains a code 
set by the test section that defines the termination circumstances and 
subsequent action to be taken for this test program* The codes are: 

Code = - Normal Termination. Print "T". 

Code = 1 - Abnormal Termination. Proceed to next section of pro- 
gram, if any. Print W T* W . 

Code > 1 - Abnormal Termination. Terminate Job Request. Print 
"T**. Print "JOB TERMINATED." 

When all sections have run, the test-loop flag in the section control 

table is tested. If set, the entire section list is processed again. 

If it is not set, control Is passed to a point where a request for a new 

job request will be made. 

R estrictions : Used only by class E users. 

Modules /Macros ; 

GATE (CZAAB) - Communication with user. 

OLT Device Allocation (CZATc) - Obtain use of devices; build device 

portion of section control table. 

USATT - Direct SYS1N .-ittentions away from com- 

mand system. 

SIR - Enable interrupt control block. 

CLATT - Direct SYSLN attention to command 

system. 

STTMER & TIMER - Establish random number. 

.Dynamic Loader SVC 127 - Load test sections. 

Test Sections (CNNNNX) - Run test pr oqrrcims . 



♦If a 2250 is being tested, the SDAT table, which is fetch- protected, is 
moved to an area of storage that can be read by nonprivileged test sec- 
tions. This makes it possible for these tests to obtain necessary 
information. 
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Exits ; To exit from this routine, the user must cause an attention 
interrupt. A routine ^ill prompt for and execute an exit procedure. An 
exit to the Command System may also be made by responding to any prompt- 
ing message with E, END, or EOT. An exit to the Command System will be 
made if the return code from CZATG is 8. 

OLTS Device Allocation Routine (CZATG) 

This routine scans the device field of the CE input request line. It 
determines the devices to be tested and takes action to ensure that they 
have been dissassociated from operational requirements. It constructs 
the device fields of the section control table. 

Entry Point : CZATG1, via Type-II linkage from CMATF. 

Input : On entry, general register contains either zero, or a pointer 
to the device field of the CE input line. If zero, prompting is 
required. 

Operation : 

1. The privilege class of the user (in the Task Common table) is 

tested. If the user has privilege class E, the OLTS bit is set to 
one in the ISA to inform system device management routines that 
OLTS is interfacing with them. If the user does not have privilege 
class E, the job is terminated. 

| 2. The SDA and SYSIN data are located via the XTRCT macro. 

3. If prompting is indicated, a message defining the required input 

format is sent to the CE. In nonprompt mode, register points to 
the first character of the device field on entry to the routine. 

**. The device field is scanned for three types of device entry: sub- 
system, identified by the characters SUBDD; terminal, identified by 
the characters TDDD; and local device, identified by the characters 
HHHH. These are hexadecimal characters identical to the device's 
SDAT identity. D is a decimal digit. In addition, a specific 
path to a device may qualify a terminal or local device name. 
The specific path is represented by HHHH where H is a hexadecimal 
digit. 

5. When a subsystem entry is encountered, the subsystem definition 
record (Appendix F) is retrieved, via VISAM, from the subsystem 
table. The contents of the input line scanner are saved, the 
scanner is pointed to the subsystem record, and control is passed 
to the main scan function (item 6 below) . For nonsubsystem 
entries, the main scan function is started immediately. 

6. A check is made to ensure that a legitimate combination of charac- 
ters for a device or terminal is present. Then a check is made to 
determine whether a specific path is present. If present, the path 
is converted to binary and saved in the section control table, and 
the specific path flag is turned on. 

If the device is a terminal, item 7 is followed? otherwise, item 10 
is followed. 

7. If the device is a terminal, a record (Appendix E) describing its 
characteristics is retrieved, via VISAM, from the terminal table 
and added to to an internal table. The terminal flag is turned on 
in the section control table (CHASKT) . If the terminal is SYSIN, 
item 10 is followed; otherwise, item 8 is followed. 



8. If the terminal is not SYSIN, it can be reached either via a dedi- 
cated line or via any line that has an autocall adapter. The 
details are extracted from the terminal table record. 

9. If an autocall unit (ACU) is indicated, a check is made to see 
whether a line with an autocall adapter that can be used to reach 
this terminal has been obtained. If so, it is used; if not, the 
SDAT is searched for a suitable entry and if one is found, the pro- 
cedure in item 10 is followed. If no suitable line can be found, a 
message is printed, and this device entry is skipped. 

10. If the device to be tested is SYSIN, whether a terminal or a local 
device, its SDA is obtained by using the XTRCT macro. A pointer to 
the SDAT is derived from the Task Common entry (TCMSIN) , and the 
SYSIN flag in the section control table is turned on. Item 12 is 
then followed. If the device is not SYSIN, the procedure in item 
11 is followed. 

11. A local I/O device that is being tested, or that is necessary to 
test a terminal, must be listed in the SDAT (see Note 1, after item 
15). The device's SDAT entry is found, and a check is made to 
determine whether it is private. If private, CZAEA is called to 
obtain the device's allocation and construction of its JFCB (see 
Note 2). If the device is not private, its SDAT CE bit is tested. 
The CE bit must be set before OLTS will use a nonprivate device. 

If the CE bit is set, CZAEA is called, via the DDEF macro, for 
allocation and JFCB construction. 

12. The system symbolic name of the local I/O device and its charac- 
teristics word are moved from the SDAT, using the derived SDAT 
pointer, to the section control table. 

If the device is a direct access device (DAD), with demounting 
capabilities or a tape drive, steps are taken to ensure that a CE 
volume is mounted. If correct volume mounting for a DAD cannot be 
verified, indicators are set in the section control table to inhib- 
it writing via OLTAM. (Read or SEEK tests may still operate.) 

13. A slash in the field being scanned signals the end of the field. 
If a subsystem scan is in process, the slash signals its termina- 
tion; the main stream pointer is restored and scanning resumes. If 
a slash is encountered when no subsystem is being processed, the 
end of the device field has been reached. 

14. When device specification is complete, a list of I/O devices to be 
used is printed. If any errors were encountered, the CE is given 
the option of erasing current selections and reentering new 
selections. 

15. Finally, the device fields of the section control table are moved 
to protected storage to guard against possible alteration by a non- 
privileged program. 

Note 1 : All local I/O devices are listed in the SDAT. This includes 
allocable and nonallocable devices. Each 2702 line is considered a 
device. 

Note 2 : CZAEA (DDEF) is called by problem programs to obtain use of 
devices and for construction of job file control blocks ( JFCBs) . The 
JFCB contains information describing a data set and/or device and must 
be present for use by system access methods. Normally, allocation is 
restricted to available private devices; however, CZAEA and CZCAA take 
the following special actions if OLTS is the caller: 

Introduction 9 



* & n V private device is allocated if it is not in use, 

* Private devices marked as in use (not available) are allocated if 
the SDACE flag is on. This flag is set by the HOLD command (see IBM 
System/360 Operating System: Operator's Guide y Form C28-2033). 

* Nonprivate devices are allocated. 

* All volume mounting is bypassed* 

* A JFCB is constructed for any device. 
Devices are not allocated if they are partitioned. 

E rro r Checks : A check is made that the user has privilege class E. If 
not, a call is made to ABEND* 

Restr ictions : Restricted to Class E users. 
Modules /Macros 



DDEF 
FINDJFCB 

OPEN 



(CZAEA) - Allocate devices; build JFCBs. 

(CZAEB) - Find JFCB- ♦ 

(CZCLA) - Open DCBs for subsystem and terminal 
tables. 



VISAM READ 
GETMAIN 



(<"zer»F> 

\CZ( r.< } 



Read terminal and subsystem tabJ ^s , 

i d / wr i t e s t ' - * a n » * t < > p I ; : \ < ; e S DA I 



*' >?,. a i n 
in . 



SET TIMER 

TEST time:- 

WTOR 
OLTAM EXIO 



Time I/O operation. 



C( S/.Bo) - W: i te n? \.:iqe to syrtent operator, 

(cZATA) - Verify CE pack or bin mounted on direct 
access device. 



RELEASE 

GATE 
SYS ERR 
ABEND 



(CZAFJ) 
<rz R . A :•••> 

(SVC 22 8) 
(CZACP) 



el ease 



lev i ren rjrid J K*"Ti 



:v f <or t ill- >q I t:.j l occu rrences . 
•orce abnormal task termination. 



Exit: On exit, register 
ended the device field. •:<* 
return codes: 



points to the by t e f o 1 1 o w L rig the slash 1 ! > a t 

« i i c * t { n: t S r onr a i ns one of t h e f ol 'I owi i , a 



Return Code 





Me aning 

Norrr*a i return 

A request for initialization or an attention was 
received as a response to a prompting message* 

A : -'Spoil re •"•£ r f END. u r.OT was made to 3 prompt I »-<q 
fues:.: 3ge. 
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OLTAM Execute I/O (CZATA) 



This routine constructs an IORCB from parameters provided by a cal- 
ling test routine and passes the IORCB to the IOS for execution. 

Entry Point : CZATAl f type- I or type-II linkage 

Input: Upon entry, register 1 contains a pointer to the following pa- 
rameter list which is located in the calling test program: 



Address 


of 


TECB 






Address 


of 


Active SCT Entry 


Address 


of 


ccw 


List 




Address 


of 


Flag 


Word 





1 Byte 



1 Byte 



CCW 



Count 



O 



oo 



o 




12 3 4 5 6 
Operation : On entry, OLTAM immediately checks whether the user has pri- 
vilege class E. If not, an exit is made to ABEND. 

A check is made to determine whether CZATG COLTS Device Allocation 
routine) is the calling program. If so, section control table CSKT) 
validity checks and data integrity checks are bypassed. If not, the 
checks are made. 

First a check is made to ensure that the test program has provided a 
valid SKT pointer, and that the device fields of the SKT have not been 
altered. SKT alteration or an invalid SKT pointer results in a call to 
ABEND. 

Next, it is determined whether a direct access device CDASD) is being 
tested. If so, the following restrictions are enforced: 

1. For 2311, 2314, or 2301 devices, the first CCW in the chain may be 
any type of command except WRITE or SEARCH? for all other DASDs , 
the first CCW must be a control seek Cop code 07) . 

2. For all DASDs, the second CCW must be a SET FILE MASK command. 

If either condition is not met, a call is made to ABEND. 

The file mask operand of the second CCW is set as indicated in Table 
1. The flag field of the SKT entry for the device will have been set by 
CZATG to tell whether CE volume mounting was verified. 

Seek sections are identified by testing a bit in their section 
preface. 

Writing on 2321s is confined to cell # subcells 16 to 18 (CE bin 

only) . Writing on 2302s is confined to cylinder 250 and above. This is 
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done by checking the initial seek operand and allowing head seeks only 
thereafter. 



Table 



Data Integrity Measures for DASDs 



r _ T _ . — T — _. . 

| 1 | 2 | 3 

If | Then (Then 

CE volume j set file jset file 

mount [mask to |mask to 

verified fallow (allow 

(writing (any seek 

Any seek section) - | N | Y 

2311/2314 ( Y* | Y | Y 

nonseek section |— -j- — 1~~— — — 

N | N | Y 

Y | Y | N 

N | N | N 

) Y I N 



T — _ . — T _„_ 1 

|*15( 

Then (Then 
set file j check 

mask to (limits of 
allow seek | initial 
head only (seek 

N j N 

N j N 

N | N 

Y | Y 

Y | Y 

Y 1 Y 

I 

N I N 



2321 nonseek 
section 



2302 nonseek 
section 

2301 nonseek 
section 



I Y | Y 



|~ 



Y=yes; N=no; -=not relevant 

*=SET FILE MASK of test section is used. 



The constant fields of the IORCB are completed first; then the fol- 
lowing variable fields are completed, as specified by the calling 
program. 

• The DECB address field- This will point to an OLTS-defined Test 
Event Control block (TECB) (Appendix D) . Status data will be placed 
in the TECB by the OLTAM posting routine* 

• The 2-byte, 4~digit system symbolic device address field.. 

• The DEB pointer field is used to save the starting VM address of the 

CCW list. This is used by OLTAM posting to convert the final CSW 

address from a real to a virtual address* 

• The CCW list length field. 

• The CAW key is set depending on the privilege of the calling 
program. 

Then the TECB in the calling program is cleared. 

If a specific path is associated with this request, the IORCB specif- 
ic path flag is set, the physical address is entered in the IORCB, and 
the IORCB "ignore down indicator" flag is turned on. This flag tells 
PATHFINDER routine to override a down status indication for this device. 

The CCW list is scanned and a page list and page count are generated 
and placed into the IORCB. OLTAM does not buffer any I/O transfers in 

the IORCB. 

Next, the origin of the CCW list in the IORCB is calculated and the 
CCW pointer fields are completed. 
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Then, the virtual storage CCWs are reformatted and placed in the 
IORCB. 

Finally, the length of the IORCB is calculated and inserted, and the 
HIO, software command chaining, and post PCI flags are turned on, if 
applicable. Now the build of the IORCB is complete. If a reset is 
indicated, the RESET SVC is executed. Before the IOCAL is executed, the 
SKTFLG is tested for the device type. If the device is a terminal, the 
CKALOC macro is executed to test for MTT operation. On return from the 
CKALOC SVC, register is tested for a return code. If the code is 2, 
an ABEND1 is issued; if not the IOCAL SVC in the IORCB is executed. 

Restrictions : Used only by OLTS programs. 

Modules/Macros 

IOCAL SVC - Perform I/O operation. 

ABEND (CZACP) - Force ABEND of task. 

RESET SVC - Reset. 

Exit ; No return code is provided. Return is to the calling program, 
via register 14. 

OLTAM Posting Routine (CZATB) 

This routine fields all synchronous I/O interrupts resulting from 
OLTAM- initiated I/O activity. 

It sets the complete bit in the associated OLTAM-def ined TECB, when 
applicable, and moves the status and sense data from fixed locations in 
lower virtual storage to the user's TECB. It also moves condition codes 
into the TECB. 

Entry Points ; CZATB1; type-I linkage from the task monitor. 

Input ; None. 

Operation ; This routine is the posting routine for all OLTAM I/O 
activity. 

Entry is made from the task monitor. A check is made whether the 
user has privilege class E. A call to ABEND is made if he does not. 

Flags in the IORCB for CCW specification errors or invalid path 
definition are tested. If either is set, a call is made to ABEND. 

Then a check of the intercept flag is made. If this flag is set, the 
IORCB was not executed because of an unrecoverable error associated with 
a previous IORCB; an interrupt code is placed in the test program's 
TECB, the reject I/O flag is reset, and an €*xit is made to the task 
monitor. 

If the IORCB was executed, the CSW, sense data, and condition code 
fields are moved from the ISA and the IORCB to the TECB, and the address 
in the returning CSW is converted into a virtual memory address. (The 
original VM address of the CCW list is placed in the DEB field of the 
IORCB by the OLTAM execute I/O routine to make this conversion possi- 
ble.) Then the complete bit is set in the TECB, and the active SKT is 
located. The SKTFLG is tested for MTT, and if MTT is operating the CKA- 
LOC macro is issued to reset the lock byte (returning the terminal to 
RTAM) , and control is returned to the calling routine. If MTT is not in 
operation exit is to the calling routine. 

Restrictions ; Used only by OLTS programs. 
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Module Called : ABEND (CZACP) . 

Exit: : On exit, register 15 contains zero, indicating to the task mon- 
itor that no further processing is associated with this function. 

OLTS Print (CMATC) 



This routine prints hardware failure information as it occurs for 
OLTS test programs on a device designated by the customer engineer; it 
also prints some nonfailure information messages on the same device. 

E ntry Point : CMATC1; type- I linkage. 

I nput : Upon entry, register 1 contains a pointer to a print control 
table (Appendix C> which describes the print request. 

Operation : The print control table pointed to by register 1 can contain 
requests for three different kinds of prints, heading CD, results (2), 
or comments (3) (Appendix C) . 

If a heading print (Appendix Bl) is requested, a check is made for 
the error bit in the print control word. If it is set, an * is placed 
as the first character of the heading line. The program ID and active 
routine number are moved from fixed locations relative to the save area 
in the test program and placed in the line. Then, if requested, the 
pertinent instruction counter value, CCW list address, I/O path, system 
symbolic tag, and terminal identity are placed in the heading line* 

Note : Both the instruction counter value and the CCW list address are 
referenced to the test program's assembly listing. All test programs 
are assembled at location zero. The instruction counter value points to 
the place in the listing fron which the test can be retraced; the CCW 
address is the starting address of the list of failing CCWs. 

If a results print (Appendix B2) is requested, the received CSW con- 
dition code and sense data is extracted from the TECB, and the expected 
data, or pointers to it, are extracted from the check field (Figure 5). 
Both received and expected results, or only received results, may be 
printed, depending on the request. 

A comment (Appendix B3) is printed unchanged. 

When a line of print is formed, a decision is made as to the device 
and method of output to be used. If the output device is the SYSIN- 
SYSOUT terminal, the GATE routine is used to transfer the message. 

The print control table is scanned until there are no further 
entries . 

R estrictions : All lines are limited to 74 characters to make display on 
a graphic device possible. 

Modules/macros 

OLTS convert routine (CMATE) - Conversions. 

GATE CCZAAB) - Prints to SYSIN. 

1 Exit Code : None. 

O LTS Compare (CMATD) 

This routine compares expected versus received results of I/O opera- 
tions for OLTS test programs. 
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Entry Point : CMATD1; type- I linkage. 

I nput : On entry f register 1 points to a 2-word parameter list which is 

located in the calling test program. 

Word 1 - Address of Check Field (Appendix D> 

Word 2 - Error Exit Address 

Operation : This routine interrogates the flag byte in the check field 
(Appendix D) to determine what fields are to be compared. Fields whose 
flag bits are active are compared. After all active fields have been 
compared, a bit pattern is placed in the low-order byte of register 15 
which corresponds to the flag byte of the check field. If any noncom- 
parisons are found, control is passed to the error exit address; other- 
wise* control is returned to the caller's next sequential instruction. 

R estrictions : Used only by 0LTS programs. 

M odules Called : None . 

Exit : On exit, register 15 contains a code that defines active noncom- 
paring fields. 

OLTS Convert (CMATE) 

This routine converts betwcjen hexadecimal and EBCDIC for OLTS 

programs . 

E ntry Point : CMATE1; type- I linkage. 

Input: On entry, register 1 points to a 3-word parameter list in the 

calling program: 

r . >_. — . ____ .. „ . _. , 1 

Word 1 | From Address j 

,. „„„_. _„__„„_„ _ H 

Word 2 | To Address | 

!.„_„___„_„—„_ — .„„„ __„ _ ^ 

Word 3 | Address of Control Word | 

L — . . — . ... _____ . . . . . J 

r . ._. — __„_„_.„_ . . . 1 

Control Word | |* | FROM COUNT j 

L . . ._ — . .__ JL__J._ . __ . . . . J 

15 16 17 31 

* = Flag: 1 if hexadecimal to EBCDIC; if EBCDIC to 
hexadecimal. 

Operation : Data in a "from" field is converted as requested and the 
converted data is placed in a "to" field. The "from" field is not dis- 
turbed unless it is also part of the "to" field. Illegal characters in 

a conversion from EBCDIC to hexadecimal are converted to hexadecimal 0. 

Restr ictions : None. 

M odules Called : None . 

Exit Code : If an illegal character is encountered in a conversion from 
EBCDIC to hexadecimal, register 15 is set to a positive number? other- 
wise, it is set to zero. 



Introduction 15 



FLOWCHARTS 



The flowcharts in this section are presented in the order in which 
the routines are described in the previous sections. 

Chart AA. Setup Control (CMATF) "<* w 
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Chart AB. Attention Processor (CMATF) 
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Chart AC- Section Selection CCMATF) (Part 1 of 2) 
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Chart AD. Section Selection (CMATF) (Part 2 of 2) 
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Chart AE. Routine Selection (CMATF) 
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• Chart AF. Job Option Selection (CMATF) (Part 1 of 2) 
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• Chart AG. Job Option Selection (CMATF) (Part 2 of 2) 
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Chart AH, Sequencer CCMATF) 
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Chart AI. Device Allocation (CZATG) (Part 1 of 5) 
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• Chart AJ. Device Allocation (CZATG) (Part 2 of 5) 
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Chart AK. Device Allocation (CZATG) (Part 3 of 5) 
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Chart AL. Device Allocation (CZATG) (Part ** of 5) 
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Chart AM, Device Allocation (CZATG) (Part 5 of 5) 
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Chart AN. Process Dashed Pair (CZATG) 
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Chart AO. OLTAM EXIO Routine (CZATA) 
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Chart AP. OLTAM - Data Integrity (CZATA) 
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• Chart AQ. OLTAM Posting Routine (CZATB) 
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Chart AR- OLTS Print Routine (CMATC) (Part 1 of 3) 
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Chart AS. OLTS Print Routine (CMATC) (Part 2 of 3) 
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• Chart AT. OLTS Print Routine (CMATC) (Part 3 of 3) 



♦OUTPUT 020A2* 



♦PRINT BUFFER 1 



0i********* 



*O0TPUT 020A2* 



*PRINT BUFFER 1 



* c2 ***** 
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Flowcharts 3 5 



Chart AU. Compare (CMATD) 



HOUSEKFBP 
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♦CODE JM R-G 
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Chart AV. Conversions (CMATE) (Part 1 of 2) 



ENTE 



*AXUtfPK 023A3* 

* tsp&ck * 
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Chart AW. Conversions (CMATE) (Part 2 of 2) 
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CHARACTER TC 
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*. CHAP AC TEE. 
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CHECKED . * 



♦ STORE IN OIJTFE m * 

* FIELD. STEP * 
*C-nTt J !)1 POINTER * 



SET EBCDIC 
ER^OT- FLAG. 
OSITIVE NO. TO 

GF 15 



.* MORE *. 

* INPUT *„ NO 
C HA b ACCESS . * — 
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APPENDIX A: SECTION CONTROL TABLE 



The Section Control table provides the section with all information 
required to perform the test* It is located in CMATF's PSECT. A pro- 
tected copy is also kept in CZATA's PSECT. 

r . — _ T ._ . — — — . — . .. — .. . T 1 

j | SECTION CONTROL TABLE CSKT) | 1 

| |.„. . _„ „ „„_ _„ _ _ H | 

j | +0 +1+2+3 II 
|.„„„f _„„„ „_,.„__,. T ^ T . . _„ „ + H 

1 SKT | (1) Random Number | Spare) (2) | * | < 2) Job Options | Word | 

j. ___+„. — „_ — „.„„„_„ H .... — x — .x_±„„_„„_„„„ + „. — ^ 

I +«» JO) Routine Selection | Spare | Word 1| 

^„-_+_. _- „„„_ + _„-„_._„„„_-„_„„ + __-_ H 

| +8 | (4) Sys Sym Device Name |C5> Flags |Word 2| 

j.__„ + -„„___„____--„_ - + _„„„„._„_„„„_„„_ + _„„ H 

| +12 j (6) Term Table Index | (7) Physical Address (Word 3| 

H „ + _ ._ ._„.._.„„x_._._..._„„„._„_„ + .„_.^ 

| +16 | (8) Device Characteristics (Word 4| 
fr„_„±„__ -. „-„___-____„-.._„_„„-„„„„X- ^ 

1 Words 2 f 3 f and 4 are a device entry used to describe the equipment | 
j under test. They may be repeated a maximum of 30 times to allow | 
j testing of many devices during one run. 1 

I I 

| * See Note 1 below. I 

i . . — —__„. . — . .. - _. . . . . „„j 



NOTES TO SECTION CONTROL TABLE CSKT) 



Word 

1. Random Number: The first two bytes of the SKT contain random data 
inserted by the control program. 

Bits 16-22 Unassigned 

* Bit 2 1* -Error Bit 

* Bit 25-Program Found Error Bit 

2. Job Options 

Bit 23 Scope Loop 

Bit 26 Reserved 

Bit 28 No control print 

Bit 29 No error print 

Bit 30 Loop if error 

Bit 31 Loop on test 

Word 1 : 

3. Routine Selection: When a single test section is selected, specif- 
ic routines (1-16) may be requested by the CE. Bits 0-15 will be 
set accordingly. 

Word 2 : 

4. Bytes and 1 - System Symbolic Device Name 

5. Bytes 2 and 3 - flags 
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Bit 





Bit 


1 


Bit 


2 


Bit 


3 


Bit 


4 


Bit 


5 


Bit 


6 


Bit 


7 



Reserved 

Reserved 

SYS IN 

Last Device of Subsystem 

This device listed previously in SKT. 

Terminal (index present in field 7) 

Path Definition present in field 8 

Last Device of last subsystem to be tested by this 

section 



Bits 8-15 Unassigned 



Word 3: 



Bytes and 1 - Terminal Table Index: Pointer to entry in terminal 
table if bit 5 of the flag field is set to one. 

The terminal table record format is: 



1 o 

2 7 
2 2 



H H H H 



DDD is the terminal ID and also gives its position in the terminal 
table. 

A/D/C tells whether the terminal can be reached by an auto call 
unit (A) , a dedicated line (D) , or whether the terminal is call-in- 
only (C). 

If a dedicated line must be used, HHHH is present, and HHHH is the 
SDA of the dedicated line; otherwise, HHHH is absent- 
Bytes 2 and 3 define a specific path to this device if bit 6 of the 
flag field is set to one, (OLTAM will use this path only for I/O 
operations. ) 



Word 4: 



Device Characteristics: Moved here from SDAT table. 

These characteristics are defined in IBM System/360 Time Sharing 
System: System Control Blocks PLM , Form Y28-2011. 



Notes : 

1. Number of devices in SKT is variable (1-31). End of list is 
reached when "last device of last subsystem" flag is set. 

2. A subsystem is one or more devices logically connected. 

3. For programs that use standard access methods, each SKT entry has a 
potential ddname. If the SYSIN flag is set, the ddname is SYSIN; 
otherwise, it is SYSOLTnn, where nn is the entry number. 
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APPENDIX B: OLTS PRINT FORMATS 



The On Line Test Control program has three print formats: 
1. *PPPPPPPP RR IOLLLLL CCW-XXXXX TOADDR-AAAA UNIT-XXXX TERM-NNN 



2. RCVD COl CSW-XX AAAAAA SSSS CCCC SNS-SS SS SS SS SS SS SS SS DATA- 
DDDDDD 



XPCTD 
DDDDDD 



XX AAAAAA SSSS CCCC 



SS SS SS SS SS SS SS SS 



3. ANY COMMENT (74 characters, maximum) 

In 1, a heading, the programmer supplies Cvia the print control 
table) the listing main program address LLLLL, the listing CCW address 
XXXXX, and the address of the active SKT entry from which the device 
address (path) AAAA, the unit symbol XXXX f and the terminal ID NNN can 
be derived. Any of the parameters may be omitted except program ID and 
routine number. The * is inserted automatically on an error print call 
if a heading is to be printed, 

A "results" printout, form 2, is done by use of a check field in the 
test program. This field contains the "expected" status, sense, cc, and 
data, as well as pointers to those actually received. All fields are 
optional. Unpredictable items in the XPCTD field of the CCW are printed 
as Xs. A "single line print" flag in the check field causes only the 
RCVD line to print. When fields are omitted, the print image is 
squeezed left. 

Form 3 enables the printing of any comment. 
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APPENDIX C: 



PRINT CONTROL TABLE 



tford Boundary 



<-l byte-> <-l byte-> <-l byte~> <-l byte-> <-l word~> 

f __ . T - .____„ .. T „.„_„_. T~" — — T — — 1 

Control 1 Forms | A | B | Address 
7 1 8 15 1 | ( 

i ( I 



I 



I 
—_X- 



I 
. X— 



I 
-X- 



1 I 

I I 

1 1 

-„„X_„-.— — — .J 



FLAGS IN CONTROL BYTES 



Bit Meaning if bit is set to 1 . 




1 
2 
3 



5 
6 
7 

8-15 



Last Entry 
Heading Print 
Results Print 
Print Override 



Comments Print 



Error Flag 



- return control after this entry. 

- address field points to subtable. 

- address field poi nts to a check field, 

- if this bit is set, no printing will take place 
for this control word, regardless of other bit 
settings. The "last entry ** flag will be checked, 
normally. 

- B field hciS count r address field has starting 
address. 

- Reserved 

- Spares 

- Spare 



SUBTABLE (HEADING PARAMETERS) 






Full word 



Boundary 



7 
Control 



- T __ 



Listing Instruction Counter Address 
Listing CCW Address * 



(Word Of 

(Word 1 j 

„„„__„„„_„_„_„„_-„_„„„„„„„„_ + _„_ H 
Address of a word that points to the Active SKT entry) Word 2| 
„„„-„„„„..„--.-„„„_„_„_„„„_ „_x_— H 

♦word is absent if corresponding control flag not present. | 
— „_- .«„-„„—— .„„.„„- .. _. „__ -— . .. ________ j 



Control Bi t 


1 
3 



,M> -an lag 

Print device ID. 
Listing address present. 
CC W Ad dress P r es en t . 



42 



APPENDIX D: OLTS TEST EVENT CONTROL BLOCK AND CHECK FIELD 



TECB 
r — 1 

1 ECB J 
I. T 4 

| RCVD 1 | 

|SIO CC | RCVD CSW | 
| (1 byte) | [ 

j. x 4 

| RCVD CSW J 

,. 4 

j RCVD SENSE j 
|. 4 

j RCVD SENSE 1 

H 4 

(Sense Status Information | 

L J 



CHECKFIELD FLAGS 



CHKFLD 



(2 bytes) 
Flags 



_ T T 1 

| Data * | Sense 
I Count | Count 

-X x . 



Pointer to TECB 



SIO CC 
XPCTD 



XPCTD 



CSW 



** 



XPCTD CSW ** 
XPCTD SENSE 



XPCTD SENSE 
Pointer to RCVD DATA *** 
Pointer to XPCTD DATA **** 



J 



Byte 



Bit 


Active Field (if flaq bit = 


= 1] 





CC 




1 


CSW ADDR Field** 




2 


Device Status** 




3 


Channel Status** 




4 


CSW Count** 




1,2,3,4 


Entire CSW 




5 


Sense Data is relevant 




6 


Not Used 




7 


Data is relevant 





Byte 1 

Bit 


Notes : 



Meaning (bit = 1) 

Single- Line Print (vs. Two- Line Print) of received infor- 
mation, as defined by other flags. 



Setting any CSW field flag causes entire RCVD CSW to print, 
be printed on the XPCTD line for all fields not active. 



Xs will 



* Data Count < 256 for compare routine. 

< 74 - X for print routine, where X is everything 
else on line. 
** Last seven bytes of CSW only. 
*** May be absent if data is not relevant. 
**** May be absent if data is not relevant or single- line print set. 
Condition code is two low-order bits (binary). 
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APPENDIX E: OLTS TERMINAL TABLE 



The OLTS terminal table is a list describing all OLTS - supported ter- 
minals for a given installation. It lists supported devices charac- 
terized by a level of addressing beyond that handled in the address 
field of a computer I/O instruction, namely remote 1050, 2741 , and 2260 
devices. 

Since the table varies with each installation, it must be. generated 
and maintained by the customer engineer at the installation. The DATA 
and MODIFY commands of the command language are used to do this; thus, 
the records are in the VTSAM format. 

A terminal is uniquely identified within the terminal table by its 
line number; the name of a terminal is formed by concatenating the 1 ' three 
significant low-order characters of its line number with the character 
T. Thus a terminal name is of the form TDDD f where D is a decimal 
digit. 

The table will be located on a permanently mounted public volume. 

Use: The table is referenced by the OLTS device allocation routine 
(CZATG) in setting up a test request. It is referenced by the test pro- 
gram in testing the terminal and by the OLTS print routine (CMATC) in 
identifying the terminal in a failure print. 

The terminal table record format is: 



;serted by DATA command 



Inserted by CE 



H H H H 



DDD is the terminal ID, and also gives its position in the terminal 
table. 

A/D/C tells whether the terminal can be reached by an auto call unit 
(A), a dedicated line CD), or whether the terminal is call-in-only CO. 

If a dedicated line must be used, HHHH is present, and HHHH is the 
SDA of the dedicated line; otherwise, HHHH is absent. 

X = for car d reader input; 1 for typewriter input. 

= zero. 

1050/2741/2260 gives the terminal type. 
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APPENDIX F: OLTS SUBSYSTEM TABLE 



The OLTS subsystem table contains an entry for each defined physical 
subsystem in a time sharing system. The CE may define these subsystems 
as he sees convenient. 

Each defined subsystem has a name. By pointing to the subsystem, the 
CE can point at once to all of its components. The components are 
listed by either their system symbolic device name, if they are local 
I/O devices, or by their identity in the OLTS terminal table, if they 
are terminals. 

A subsystem table is generated and maintained by the customer engi- 
neer, using the DATA and MODIFY commands; therefore, the records are in 
VISAM format. 

A subsystem is uniquely identified within the subsystem table by its 
line number; its name is formed by concatenating the two significant 
low-order characters of its line number with the characters SUB. Thus, 
a subsystem name is of the form SUBDD. The device entries in the rec- 
ords must conform exactly with the format specified for a device field 
in the CE Guide. 

Use ; When the CE specifies that a subsystem is to be tested, each of 
its elements is entered into the section control table for the test pro- 
gram involved. 

Format: 









Inserted 


by DATA 
.A 


Command 














Insertec 


by CE 






_ 








—-*> 


f 










") 








o- 


L 







1 


D 


D 








X 


Device 

En fry 1 t 


Device 

Entry 2 


Device 
Entry 3 


f 1 Device 


. 




























L 











DD is the subsystem ID and also gives its position in the subsystem 
table. 

= z ero . 

X = for card reader input; 1 for typewriter input. 

Device Entry Formats : 

HHHH Local device 

HHHH (HHHH) Local device via specific path 

TDDD Terminal 

TDDD Terminal via specific path 
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APPENDIX G: SYSTEM TABLE DATA REFERENCES 



_ T 

I c 
I M 

I A 

I T 

I F 

-+— 



T* 

c I 
z I 

A I 
T | 

G I 
— +- 
C I 
— +- 



T T" 

C | C | 
M I M I 
A | A | 
T | T | 
D | E | 
— + +- 



Module 



I 



Table 
Interrupt Storage Area (ISA) 



-+- 



c I 

M | 
A | 
T | 
C | 
— + 



C I 

Z I 

A | 

T | 

A I 



— + J 

R I R 



-+- 

I 
-+- 



I/O Record Control olock (IORCB) 

Symbolic Device Allocation Table (SDAT) 

Adcon DSECT (ADC) 

Task Data Definition Table (TDT) 

Task Common Table (I'CM) 

Data Control Block DSECT (DCB) 

OLTS Section Control Table (SKT) 

OLTS Test Event Control Block (TECB) 



-+— 

I - 

-+— 

I c 

-+— 



-+- 



-+- 



— +- 

R I 
— +- 



-+- 






I 
-+~ 

I c 
-+— 



+- 



-+ 



-+- 



R I 
— +- 
R I 
— +- 
c I 

c I 
— +- 
c I 
x. 



— + + 

- I - I 
— + + 



C I R 
— + 



— +- 
C I 

— +- 

R I 
— +- 
- I 

JL_ 



— + +" 

" I - I 

— T + 

- I " I 

— + +- 

" I - I 
— + +" 

" I " I 

— + T- 

" I - I 
X X. 



— + 

" I - 
— + 



— + 

R | R 

— + 

- I - 

— + 

R | - 

— + 

C j C 
x 



|R - Reference only; C - Change 

L 
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